@database P90Install.guide
@$VER: P90Install v1.00 documentation (c) 1999 John Girvin/Halibut Software @smartwrap

@rem -----------------------------------------------------
@node main "P90Install - Main index"
@{jcenter}
@{b}
                     P90Install  v1.00
Hard drive installation and trainer package for Paradroid90

           (c) 1999 John Girvin/Halibut Software

@{ub}

    @{" Description                  " link description}
    @{" Licence and Distributability " link legal} @{b}IMPORTANT!@{ub}

    @{" Requirements                 " link requirements} @{b}IMPORTANT!@{ub}
    @{" Usage notes                  " link notes} @{b}IMPORTANT!@{ub}
    @{" Shareware information        " link shareware}

    @{" Installing                   " link installing}
    @{" Options                      " link options}
    @{" Playing                      " link playing}

    @{" Troubleshooting              " link trouble}
    @{" Known problems               " link problems}

    @{" Author information           " link author}
    @{" Project history              " link history}
    @{" Future plans                 " link future}
    @{" Acknowledgements             " link acknowledge}


@{b}
                    @{"P90Install is SHAREWARE" link shareware}
If you have not already done so, please consider @{"registering" link shareware}!
@{ub}
@endnode

@rem -----------------------------------------------------
@node legal "P90Install - Licence and Distributability"
@toc main

@{jleft}
@{b}@{u}P90INSTALL LEGAL INFORMATION@{uu}@{ub}
These are the licence and distribution conditions for P90Install.

Using the package implies that you agree with and submit to these
conditions. If you do not agree with the conditions laid out below
you are not permitted to use P90Install and must delete all files
in your possession related to it @{u}NOW!@{uu}


@{b}@{u}P90INSTALL LICENCE CONDITIONS@{uu}@{ub}
@{jcenter}
@{b}
     P90INSTALL IS PROVIDED "AS IS" AND IS USED AT YOUR OWN RISK

          NO GUARANTEE EITHER EXPRESS OR IMPLIED IS GIVEN,
                     NOR SHOULD ANY BE INFERRED
@{ub}

          The author cannot be held liable for any loss or
         damage caused by the use or misuse of this package

You are permitted to try the unregistered version of P90Install for a
period of 30 days. After this period you must either @{"register" link shareware} to obtain
the full version of the package or delete any installation of Paradroid90
created with P90Install.

@{jleft}
@{b}@{u}P90INSTALL DISTRIBUTION CONDITIONS@{uu}@{ub}

P90Install is (c) 1999 John Girvin/Halibut Software

The @{"unregistered" link shareware} version of the package is freely distributable,
provided that all files that are part of the package are included
unchanged in any distribution and no more than minimal handling
or media costs are charged.

@{b}The @{"registered" link shareware} version of the package may not be distributed
in any way except by the author or his appointed agents.@{ub} It is for
the sole use of the person or persons in who's name the original
registration is in. Registrations cannot be transferred to other
individuals or groups.

Each @{"registered" link shareware} package is personalised and the identity of the
original owner may be traced if an infringing copy is found. In
this case any registrations of this package and any other Halibut
Software packages in the name of the offending parties will be
cancelled and no further registrations will be accepted.

There are @{b}NO EXCEPTIONS@{ub} to this rule.

Its in your own interest to keep your @{"registered" link shareware} copy secure!

@endnode

@rem -----------------------------------------------------
@node description "P90Install - Description"
@toc main

@{b}@{u}P90INSTALL DESCRIPTION@{uu}@{ub}

This is a hard drive installation and trainer (cheat) package for the
Hewson/Graftgold game "Paradroid90". It allows you to install the game
to your Amiga's hard drive and play it from there with no need for the
original floppy disk after installation. It includes trainers (cheats)
to give the player infinite energy and stop the energy drain.

@{b}THIS PRODUCT IS SHAREWARE!@{ub} The unregistered version has a number of
restrictions which are not present in the registered version. Please
refer to the @{"shareware information" link shareware} section for further details and
information on how to obtain the full, registered version of P90Install.

@endnode


@rem -----------------------------------------------------
@node requirements "P90Install - Requirements"
@toc main

@{b}@{u}P90INSTALL REQUIREMENTS@{uu}@{ub}

* Requires version 43.3 or later of the "Installer" program (or compatible).
  Installer v43.3 is available for free download from Aminet:

      ftp://wuarchive.wustl.edu/pub/aminet/util/misc/Installer-43_3.lha


* Requires version 10.2 or later of the WHDLoad package by Bert Jahn.
  WHDLoad must be installed prior to starting P90Install. The latest
  WHDLoad package and more installers for many other games and demos
  may be obtained from the WHDLoad support web page at:

      http://www.fh-zwickau.de/~jah/whdload.html


* Requires approximately 1Mb of free space on your hard drive.
  Please do not attempt installation if you have less than this
  amount free on the partition you intend to install Paradroid90 on.


* Requires an @{i}original@{ui} (non pirate) game disk!
  This installer is unlikely to work with any pirate versions of the
  game, nor will I ever modify it to do so.

@endnode


@rem -----------------------------------------------------
@node notes "P90Install - Usage Notes"
@toc main

@{b}@{u}P90INSTALL USAGE NOTES@{uu}@{ub}

* When running the installer it is advisable to disable any virus
  checking software you may have running. The original game disk
  uses a non-standard bootblock which will most likely cause your
  virus checker to complain and this could interefere with the
  installation process. It is not necessary to disable such programs
  before playing the game once it is installed.


* Do not attempt to crunch or pack the game files (the files found in
  the "data" subdirectory) or the "Paradroid90_HD" or "P90HD" programs.

@endnode

@rem -----------------------------------------------------
@node installing "P90Install - Installing"
@toc main

@{b}@{u}INSTALLING PARADROID90 WITH P90INSTALL@{uu}@{ub}

Please read the @{"licence" link legal}, @{"requirements" link requirements} and @{"usage notes" link notes} sections first!

    @{" Installing the unregistered version " link inst_unreg}
    @{" Installing the registered version   " link inst_reg}

@endnode

@rem -----------------------------------------------------
@node inst_unreg "P90Install - Unregistered installation"
@toc installing

@{b}@{u}INSTALLING PARADROID90 WITH THE EVALUATION VERSION OF P90INSTALL@{uu}@{ub}

1. Extract all files in the archive to your system. They will be
   extracted to a drawer called "dist"

2. Open the newly created drawer and double click the "Install"
   icon located there.

3. Follow the instructions given to you by the Installer program!

The game will be installed to a directory you select on your hard drive.

Please refer to the @{"shareware information" link shareware} section for further details
on the differences and restrictions of the unregistered version and
information on how to obtain the full, registered version of P90Install.

@endnode


@rem -----------------------------------------------------
@node inst_reg "P90Install - Registered installation"
@toc installing

@{b}@{u}INSTALLING PARADROID90 WITH THE FULL VERSION OF P90INSTALL@{uu}@{ub}

Before you install the full, registered version of P90Install, you must
first have an existing installation of Paradroid90 created with v1.00 or
later of P90Install (either unregistered or registered). The registered
installation process is only an upgrade to an existing installation.

When you have a previous working installation of Paradroid90:

1. Extract all files in your personal registered upgrade archive.
   They will be extracted to a drawer called "reg"

2. Open the newly created drawer and double click the "Upgrade"
   icon located there.

3. Follow the instructions given to you by the Installer program!
   * all trainer and trainer-GUI related choices are merely @{b}default@{ub}
     values and may be changed after installation.

   * when asked to insert your game disk, do so and wait for the
     floppy activity light to go out before clicking the 'Proceed'
     button.

The game will be installed to a directory you select on your hard drive.

@endnode


@rem -----------------------------------------------------
@node options "P90Install - Options"
@toc main

@{b}@{u}OPTIONS FOR THE INSTALLED GAME@{uu}@{ub}

P90Install provides a number of options that may be activated or deactivated
using a GUI or, in the registered version only, command line parameters and
tooltypes. A number of in-game functions are also available.


@{b}@{u}SETTING OPTIONS USING THE GUI@{uu}@{ub}

The P90Install GUI allows you to select the options you wish to have actived
during the game.  Note that in the unregistered version, most of these will
be @{"disabled" link shareware}.

To activate an option, e.g.: Infinite Energy, you must click on the appropriate
gadget. A checkmark (tick) will appear in the box beside any activated option;
if the box is empty then the option is inactive.

When you have selected the options you require, click the "Play" button in the
lower left of the window. The game will now load and run if possible.

If you started Paradroid90 by mistake, or have changed your mind and do not want
to play the game right now then click the "Cancel" gadget in the lower right
of the window.


@{b}@{u}SETTING OPTIONS USING COMMAND LINE PARAMETERS@{uu}@{ub}

This function is available in the registered version only. Please refer to
the @{"shareware information" link shareware} section for further details on the differences
and restrictions of the unregistered version and information on how to obtain
the full, registered version of P90Install.

The registered version of the program "Paradroid90_HD" supports a number of
command line parameters that allow you to specify the default options you
require:

@{u}"NOGUI"@{uu}
Specify this parameter to disable the trainer GUI. If the GUI is disabled
then the game will run with the options specified in the other parameters.

If the NOGUI parameter is not present then the trainer GUI will appear.


"INF_ENERGY"
@{u}"NO_DRAIN"@{uu}
Specify any combination of these parameters to set the default state of
the corresponding option. For example, if you specify the "INF_ENERGY"
parameter then the infinite energy option will default to being activated.

If any of the above parameters are not present, then the corresponding
option will default to being inactive.


@{b}@{u}SETTING OPTIONS USING TOOLTYPES@{uu}@{ub}

This function is available in the registered version only. Please refer to
the @{"shareware information" link shareware} section for further details on the differences
and restrictions of the unregistered version and information on how to obtain
the full, registered version of P90Install.

The registered version of the program "Paradroid90_HD" supports a number of
tooltypes that allow you to specify the default options you require. Refer
to your operating system documentation for details of how to set and edit
icon tooltype values.

Note that if the "Paradroid90_HD" program is started from shell then the
options specified by its tooltypes are ignored and the shell parameters
are used instead.


@{u}"NOGUI"@{uu}
Specify this tooltype to disable the trainer GUI. If the GUI is disabled
then the game will run with the options specified in the other tooltypes.

If the NOGUI tooltype is not present then the trainer GUI will appear.


"INF_ENERGY"
@{u}"NO_DRAIN"@{uu}
Specify any combination of these tooltypes to set the default state of
the corresponding option. For example, if you specify the "INF_ENERGY"
tooltype then the infinite energy option will default to being activated.

If any of the above tooltype are not present, then the corresponding
option will default to being inactive.


@{b}@{u}IN-GAME OPTIONS@{uu}@{ub}

When the game is running, the following keys may be used:

        @{b}F8@{ub} = quit the game and return to the trainer GUI
                       If the "NOGUI" option was specified the trainer GUI
                       will exit immediately after the game is exited.

@endnode

@rem -----------------------------------------------------
@node playing "P90Install - Playing"
@toc main

@{b}@{u}STARTING THE INSTALLED GAME@{uu}@{ub}

From Workbench, open the drawer created during installation and double click
on the "Paradroid90_HD" icon found within it. From a shell or shell script, execute
the "Paradroid90_HD" program. Do not try to start the "P90HD" WHDLoad slave directly
as it will most likely crash!

If you are using the @{"registered" link shareware} version of P90Install and have specified the
"NOGUI" @{"option" link options}, the game will now start using the default options specified
in the other @{"parmeters or tooltypes" link options}.

If you are using the @{"unregistered" link shareware} version or have not specified the "NOGUI"
option on the registered version, the trainer GUI will appear instead. You
may now use the GUI to modify the @{"options" link options} you wish to have active during the
game.

@endnode


@rem -----------------------------------------------------
@node trouble "P90Install - Troubleshooting"
@toc main

@{b}@{u}P90INSTALL TROUBLESHOOTING@{uu}@{ub}

Please read the @{"usage notes" link notes} and @{"known problems" link problems} sections of
this document if you have not done so already. They contain important information
which may help resolve your problem quickly.

If you are using a pirate copy of the game, stop reading now. I will make no
fixes for pirate copies the game. Don`t even ask.

If you are going to send a bug report please include at least the following information:
* version of the game (eg. 1 MB English Version ECS), number of
  disks etc.

* configuration of your machine including type of Amiga, CPU, CPU
  speed, amount of chip and fast memory, gfx chipset (OCS/ECS/AGA),
  special hardware, kickstart version

* description of what happens eg: error while installing, error while
  starting, gfx errors, keyboard hangs, game crashes on level 15 etc.
  It helps if you describe @{i}exactly@{ui} when the error happens
  and if it happens all the time or just now and again.

All bug reports should be sent to the @{"author" link author}.

@endnode


@rem -----------------------------------------------------
@node problems "P90Install - Known Problems"
@toc main

@{b}@{u}P90INSTALL V1.00 KNOWN PROBLEMS@{uu}@{ub}

- none

Please @{"contact me" link author} if you experience problems with P90Install.

@endnode


@rem -----------------------------------------------------
@node history "P90Install - History"
@toc main

@{b}@{u}P90INSTALL PROJECT HISTORY@{uu}@{ub}

    1.00  07/99
          - first version

@endnode


@rem -----------------------------------------------------
@node future "P90Install - Future Developments"
@toc main

@{b}@{u}FUTURE DEVELOPMENTS@{uu}@{ub}

* More icons! Want to draw some?

* MUI GUI? Anyone interested?

Any other suggestions? @{"Tell me!" link author}

@endnode


@rem -----------------------------------------------------
@node shareware "P90Install - Shareware Information"
@toc main

@{b}@{u}P90INSTALL SHAREWARE INFORMATION@{uu}@{ub}

P90Install v1.00 and later is released under the "shareware" scheme. This means
that two versions of the package are available:

1. a somewhat cut-down but free and publically distributable "unregistered"
   evaluation version, intended as a trial version to show the capabilities
   of the package but lacking its more advanced features.

2. a fully featured but non-distributable "registered" full version that must
   be paid for. This version has none of the restrictions of the unregistered
   version.
@{b}
@{"Earlier" link history} (pre v3.00), non-shareware versions of P90Install are no longer supported.
@{ub}


@{b}@{u}RESTRICTIONS OF UNREGISTERED VERSION@{uu}@{ub}

The unregistered version of the package is restricted in the following manner:

* The infinite energy and no energy drain options are not available
  in the unregistered version.

* Specifying default trainer configuration with @{"command line parameters" link options}
  is not implemented in the unregistered version.

* Saving default trainer configuration in the icon @{"tooltypes" link options} is not
  implemented in the unregistered version.


@{b}@{u}BENEFITS OF REGISTERING@{uu}@{ub}

By paying the small amount to register this package you are helping an Amiga
developer and encouraging the creation of future products! Thanks!

The benefits of registering this product are receiving free updates before they
are generally available and the removal of all the restrictions of the unregistered
version detailed above. Bug or problem reports from registered users will also
receive priority treatment.


@{b}@{u}HOW TO OBTAIN THE FULL REGISTERED VERSION@{uu}@{ub}

The price to obtain a personalised, @{"unrestricted" link shareware}, registered copy
of P90Install through e-mail is five Pounds Sterling (UK currency). The price
to receive your copy by other means must be negotiated with the @{"author" link author}.

The preferred payment method is cash. A UK postal order or cheque drawn on a UK bank
are also acceptable.  Other major currencies are accepted, but you must add 10% to the
converted price to cover bank currency conversion commission.

@{b}The registration payment is a one-off. No further payment is required for
subsequent product updates.@{ub}

To make your payment and arrange registration, please contact the @{"author" link author}.

@{b}Finally, thanks again for supporting Amiga shareware developers!@{ub}

@endnode


@rem -----------------------------------------------------
@node author "P90Install - Author Information"
@toc main

@{b}@{u}P90INSTALL AUTHOR INFORMATION@{uu}@{ub}


@{b}Name:@{ub}      John Girvin

@{b}E-Mail:@{ub}    girv@girvnet.freeserve.co.uk
           PGP5.0 public key available

@{b}WWW:@{ub}       http://www.girvnet.freeserve.co.uk
           Latest version always available from here!
              
@endnode


@rem -----------------------------------------------------
@node acknowledge "P90Install - Acknowledgements"
@toc main

@{b}@{u}P90INSTALL ACKNOWLEDGEMENTS@{uu}@{ub}

* "Paradroid90" is (c) 1990 Hewson/Graftgold.
  Piracy is theft. If you like the game then buy it
  (and run it from your hard drive with P90Install) !


* v1.00+ GUI uses gadget layout code developed from sources
  supplied by Hans Guijt, as used in his fMSX-Amiga project
  (Amiga MSX Emulator).


* WHDLoad is (c) Bert Jahn.
  The WHDLoad support web page with the latest version of
  WHDLoad plus installers for many games and demos can be
  found at:

      http://www.fh-zwickau.de/~jah/whdload.html


* P90Install uses WDelta (c) Bert Jahn
  WDelta is available from Aminet


* Musical support provided by DJ Adz
  http://www.adznet.freeserve.co.uk/

@endnode